home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / dev / misc / Hunk.readme < prev    next >
Text File  |  1999-07-01  |  10KB  |  232 lines
  1. Short:    Editor for hunk structure of binary files with GUI
  2. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Version:  2.15
  5. Type:     dev/misc
  6.  
  7. _____________________________________________________________________________
  8.  
  9.                          The THOR-Software Licence (v2, 24th June 1998)
  10.  
  11.  
  12. This License applies to the computer programs known as "The Hunk Processor",
  13. or short "Hunk". The "Program", below, refers to such program. The
  14. "Archive" refers to the package of distribution, as prepared by the author
  15. of the Program, Thomas Richter. Each licensee is addressed as "you".
  16.  
  17.  
  18.  
  19. The Program and the data in the archive are freely distributable
  20. under the restrictions stated below, but are also Copyright (c)
  21. Thomas Richter.
  22.  
  23. Distribution of the Program, the Archive and the data in the Archive by a
  24. commercial organization without written permission from the author to any
  25. third party is prohibited if any payment is made in connection with such
  26. distribution, whether directly (as in payment for a copy of the Program) or
  27. indirectly (as in payment for some service related to the Program, or
  28. payment for some product or service that includes a copy of the Program
  29. "without charge"; these are only examples, and not an exhaustive enumeration
  30. of prohibited activities).
  31.  
  32.  
  33. However, the following methods of distribution
  34. involving payment shall not in and of themselves be a violation of this
  35. restriction:
  36.  
  37.  
  38. (i) Posting the Program on a public access information storage and
  39. retrieval service for which a fee is received for retrieving information
  40. (such as an on-line service), provided that the fee is not
  41. content-dependent (i.e., the fee would be the same for retrieving the same
  42. volume of information consisting of random data).
  43.  
  44.  
  45. (ii) Distributing the Program on a CD-ROM, provided that
  46.  
  47. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  48. especially this licence agreement;
  49.  
  50. b) the CD-ROM is made available to the public for a nominal fee only,
  51.  
  52. c) a copy of the CD is made available to the author for free except for
  53. shipment costs, and
  54.  
  55. d) provided further that all information on such CD-ROM is redistributable
  56. for non-commercial purposes without charge.
  57.  
  58.  
  59. Redistribution of a modified version of the Archive, the Program or the
  60. contents of the Archive is prohibited in any way, by any organization,
  61. regardless whether commercial or non-commercial. Everything must be kept
  62. together, in original and unmodified form.
  63.  
  64.  
  65.  
  66.  
  67. Limitations.
  68.  
  69.  
  70. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  71. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  72. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  73. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  74. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  75. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  76. SERVICING, REPAIR OR CORRECTION.
  77.  
  78.  
  79. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  80. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  81. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  82.  
  83.  
  84.                                                         Thomas Richter
  85.  
  86. _____________________________________________________________________________
  87.  
  88. The "Hunk Processor" is a tool for editing the hunk structure of binary
  89. AmigaDOS load files (not object codes that must be linked afterwards, but
  90. complete executable binaries). 
  91.  
  92. Functions:
  93.  
  94.     Add and remove hunks, as well as relocation entries.
  95.     Merge hunks to shorten programs without "crunching".
  96.     Code optimizer to remove unnecessary jumps.
  97.     Rexx interface for automatic operation.
  98.  
  99.  
  100. The "Hunk Processor" is a quiet old program I wrote years ago, so the GUI 
  101. looks probably a bit "outdated" - but this is a tool, not a piece 
  102. of artwork. I mostly use it to patch bugs in existing programs, together 
  103. with a standard debugging tool.
  104. The plus of the "Hunk Processor" is that it keeps the relocation data after
  105. loading an executable, so after patching it the "Hunk Processor" can re-
  106. create a loadable program; the ARexx interface can be used to automatize
  107. this procedure or to simplify parts of it.
  108. "Hunk" comes with a - very simple though - build-in language for automatized
  109. optimization of executables, and some examples of these "external Hunk 
  110. OPtimizers", or "hoppers" for short.
  111.  
  112.  
  113. Extras:
  114.     -    A Rexx program that prints out all relocation data.
  115.     -    A Rexx program for automatic replacement of the
  116.         relocation hunks with the more efficient Reloc32Short 
  117.         hunks.
  118.     -    A lot of external "Hunk Optimizers", i.e. "hop" files.
  119.  
  120. _____________________________________________________________________________
  121.  
  122. The program is freeware, but the guide is not! It's priced $10, to be sent to
  123. my address:
  124.  
  125.  
  126. Thomas Richter
  127. Rühmkorffstraße 10 A
  128.  
  129. 12209 Berlin
  130.  
  131.  
  132. The guide contains the complete syntax of the .hop files, the available
  133. ARexx commands, a tutorial how to use this hunk and the complete description
  134. of all functions. I guess $10 is really not overpriced for the amount of
  135. work I invested in this program and the guide.
  136.  
  137. _____________________________________________________________________________
  138.  
  139. Changes made in 2.15:
  140.  
  141.     Fixed a problem with one of the memory copy operations. It used
  142.     overlapping domains which are not officially supported by the Os. 
  143.     Fixed.
  144. _____________________________________________________________________________
  145.  
  146. Changes made in 2.14:
  147.  
  148.     Added more ARexx commands. More in the guide.
  149. _____________________________________________________________________________
  150.  
  151. Thomas,
  152.     June 1999
  153.  
  154.  
  155. ============================= Archive contents =============================
  156.  
  157. Original  Packed Ratio    Date     Time    Name
  158. -------- ------- ----- --------- --------  -------------
  159.      628     267 57.4% 06-Jun-99 15:08:20 +Hoppers.info
  160.     6829     667 90.2% 06-Jun-99 15:07:58 +Ace_235.hop
  161.     1323     260 80.3% 06-Jun-99 15:07:58 +AddCmpSubToTst.hop
  162.      530     308 41.8% 06-Jun-99 15:07:58 +AddCmpSubToTst.hop.info
  163.     1853     303 83.6% 06-Jun-99 15:07:58 +AddSubToImmed.hop
  164.      530     310 41.5% 06-Jun-99 15:07:58 +AddSubToImmed.hop.info
  165.     4603     801 82.5% 06-Jun-99 15:07:58 +AmigaE_32a.hop
  166.      530     309 41.6% 06-Jun-99 15:07:58 +AmigaE_32a.hop.info
  167.     9188     896 90.2% 06-Jun-99 15:07:58 +AmigaLib.hop
  168.      530     311 41.3% 06-Jun-99 15:07:58 +AmigaLib.hop.info
  169.     1764     311 82.3% 06-Jun-99 15:07:58 +Asl_Add.hop
  170.      530     307 42.0% 06-Jun-99 15:07:58 +Asl_Add.hop.info
  171.      673     287 57.3% 06-Jun-99 15:07:58 +Aztec_Fix.hop
  172.      530     306 42.2% 06-Jun-99 15:07:58 +Aztec_Fix.hop.info
  173.     7509     962 87.1% 06-Jun-99 15:07:58 +Dice_206.hop
  174.      530     311 41.3% 06-Jun-99 15:07:58 +Dice_206.hop.info
  175.     2673     449 83.2% 06-Jun-99 15:07:58 +General.hop
  176.      530     306 42.2% 06-Jun-99 15:07:58 +General.hop.info
  177.     2866     580 79.7% 06-Jun-99 15:07:58 +General020.hop
  178.      530     310 41.5% 06-Jun-99 15:08:00 +General020.hop.info
  179.     8108     844 89.5% 06-Jun-99 15:08:00 +HCE_NorthC.hop
  180.      530     307 42.0% 06-Jun-99 15:08:00 +HCE_NorthC.hop.info
  181.     2064     439 78.7% 06-Jun-99 15:08:00 +Jump.hop
  182.      530     311 41.3% 06-Jun-99 15:08:00 +Jump.hop.info
  183.     6814     928 86.3% 06-Jun-99 15:08:00 +Lattice.hop
  184.      530     308 41.8% 06-Jun-99 15:08:00 +Lattice.hop.info
  185.     1335     357 73.2% 06-Jun-99 15:08:00 +Libnix.hop
  186.      530     308 41.8% 06-Jun-99 15:08:00 +Libnix.hop.info
  187.      469     220 53.0% 06-Jun-99 15:08:00 +Loops.hop
  188.      530     309 41.6% 06-Jun-99 15:08:00 +Loops.hop.info
  189.     5425     808 85.1% 06-Jun-99 15:08:00 +Manx.hop
  190.      530     309 41.6% 06-Jun-99 15:08:00 +Manx.hop.info
  191.     6427    1010 84.2% 06-Jun-99 15:08:00 +Oberon-A_16.hop
  192.      530     308 41.8% 06-Jun-99 15:08:00 +Oberon-A_16.hop.info
  193.     5152     888 82.7% 06-Jun-99 15:08:00 +OberonII_30.hop
  194.      530     307 42.0% 06-Jun-99 15:08:02 +OberonII_30.hop.info
  195.     5676     616 89.1% 06-Jun-99 15:08:02 +PCQ_12b.hop
  196.      530     309 41.6% 06-Jun-99 15:08:02 +PCQ_12b.hop.info
  197.     1027     420 59.1% 06-Jun-99 15:08:04 +RexxPlus_Fix.hop
  198.      530     307 42.0% 06-Jun-99 15:08:02 +RexxPlus_Fix.hop.info
  199.     5007     691 86.1% 06-Jun-99 15:08:02 +SASC_6xx.hop
  200.      530     308 41.8% 06-Jun-99 15:08:02 +SASC_6xx.hop.info
  201.     2872     582 79.7% 06-Jun-99 15:08:02 +Silver.hop
  202.      530     309 41.6% 06-Jun-99 15:08:02 +Silver.hop.info
  203.     2622     560 78.6% 06-Jun-99 15:08:02 +Silver_MULU_256.hop
  204.      530     308 41.8% 06-Jun-99 15:08:02 +Silver_MULU_256.hop.info
  205.      654     265 59.4% 06-Jun-99 15:08:02 +SpeedyIDE.hop
  206.      530     310 41.5% 06-Jun-99 15:08:02 +SpeedyIDE.hop.info
  207.     2548     375 85.2% 06-Jun-99 15:08:04 +SubAdd_Tst.hop
  208.      530     309 41.6% 06-Jun-99 15:08:04 +SubAdd_Tst.hop.info
  209.     1850     345 81.3% 06-Jun-99 15:08:02 +SubAddA_Tst020.hop
  210.      530     306 42.2% 06-Jun-99 15:08:02 +SubAddA_Tst020.hop.info
  211.     1200     310 74.1% 06-Jun-99 15:08:04 +SwapClear.hop
  212.      530     309 41.6% 06-Jun-99 15:08:04 +SwapClear.hop.info
  213.    49096   27390 44.2% 06-Jun-99 15:12:52 +Hunk
  214.     1096     468 57.2% 06-Jun-99 15:08:20 +Hunk.info
  215.     5665    2469 56.4% 06-Jun-99 15:14:14 +Hunk.readme
  216.      537     285 46.9% 06-Jun-99 15:08:20 +Hunk.readme.info
  217.      628     268 57.3% 06-Jun-99 15:08:20 +Rexx.info
  218.     3363    1182 64.8% 04-Jul-98 18:25:02 +PA.rexx
  219.      461     296 35.7% 04-Jul-98 18:25:02 +PA.rexx.info
  220.      256     178 30.4% 09-Jul-98 19:11:34 +Patch00.rexx
  221.      461     297 35.5% 04-Jul-98 18:25:00 +Patch00.rexx.info
  222.      644     278 56.8% 04-Jul-98 18:25:00 +Patch20.rexx
  223.      461     298 35.3% 04-Jul-98 18:25:00 +Patch20.rexx.info
  224.     1533     741 51.6% 04-Jul-98 18:25:02 +PatchFile.rexx
  225.      461     296 35.7% 04-Jul-98 18:25:02 +PatchFile.rexx.info
  226.      603     318 47.2% 04-Jul-98 18:25:00 +PrintReloc.rexx
  227.      461     299 35.1% 04-Jul-98 18:25:00 +PrintReloc.rexx.info
  228.     1387     699 49.6% 04-Jul-98 18:25:02 +ShortRelocs.rexx
  229.      461     297 35.5% 04-Jul-98 18:25:00 +ShortRelocs.rexx.info
  230. -------- ------- ----- --------- --------
  231.   180513   59520 67.0% 07-Jun-99 15:19:46   71 files
  232.